Johan W. Klüwer
2024-05-31
By Johan W. Klüwer, with Vladimir Alexiev, Melinda Hodkiewicz. Rewrite
of personal tool, ca. 2016–.
An OWL document has no beginning or end. How about narrative,
motivation, clarifications?
These are all great, but separately maintained.
Literate programming is a methodology that combines
a programming language with a documentation
language, thereby making programs more robust, more
portable, more easily maintained, and arguably more
fun to write than programs that are written only in
a high-level language. The main idea is to treat a
program as a piece of literature, addressed to human
beings rather than to a computer. […]
(Donald Knuth, Literate Programming homepage)
One document for both OWL and documentation
Make the OWL ontology document
plus provide documentation for users
Edit annotation texts in a proper environment.
from
to
(Turtle, from PCA)
Example: IOF Maintenance Reference Ontology
The IOF Maintenance Ontology ELOT document exported to HTML
The ELOT document exported to Open Document Format, then prepared
for ISO format in MS Word.
Benefits:
rdf:list
drawbacks
Within reach
Stretch targets